document.yaml•106 kB
openapi: 3.0.3
info:
title: Företagsinformation
description: >-
With this API you can retrieve company information. The API use POST for all
endpoints instead of GET because we don't want to display identification
number (which can be considered sensitive personal data) in the URL.
termsOfService: 'https://bolagsverket.se/'
version: v4
externalDocs:
description: 'API:s on Bolagsverket'
url: 'https://bolagsverket.se/apierochoppnadata.2531.html'
servers:
- url: 'https://gw.api.bolagsverket.se/foretagsinformation/v4'
security:
- default: []
tags:
- name: organisationsinformation
description: 'API to retrieve data about companies, persons, signatory power and cases.'
- name: ping
description: API to control the status of the service
paths:
/organisationer:
post:
tags:
- organisationsinformation
summary: Retrieve data about a company
description: With this operation you can retrieve data about a company.
parameters:
- name: X-Request-Id
in: header
description: >-
Client generated ID to call the API. In case of error this will be
sent in the attribute `requestId` or as a header attribute.
required: false
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
requestBody:
description: >-
An object to specify `identitetsbeteckning` (company registration
number) and if needed `namnskyddslopnummer` (used to separate
companies for organisation types that can have more than one company
on the same company registration number) and fields to specify the
information objects you want in the answer. Possible information
objects are `ORGANISATIONSADRESSER` (postal address and email
address), `FIRMATECKNING` (signatory power), `FUNKTIONARER` (company
officers), `HEMVISTKOMMUN` (domicile for the company), `RAKENSKAPSAR`
(financial year), `ORGANISATIONSDATUM` (different dates regarding the
company), `VERKSAMHETSBESKRIVNING` (description of the business
activities), `AKTIEINFORMATION` (information about stocks in the
company), `SAMTLIGA_ORGANISATIONSNAMN` (all business names including
business names in translation and secondary business names),
`ORGANISATIONSENGAGEMANG` (showing a company's assignments in other
companies, `TILLSTAND` (showing a company's permits),
`OVRIG_ORGANISATIONSINFORMATION` (other organisation information),
`ORGANISATIONSMARKERINGAR` (markings on the company), `BESTAMMELSER`
(regulations for the company), `VAKANSER_OCH_UPPLYSNINGAR` (vacancies
and other information about the company), `EKONOMISK_PLAN` (financial
plan for the company form BRF), `UTLANDSK_FILIALAGANDE_ORGANISATION`
(information about a foreign company having a Swedish branch),
`FINANSIELLA_RAPPORTER` (information about a company's financial
reports), and an optional timestamp ('tidpunkt') to retrieve
historical information about the company.
content:
application/json:
schema:
$ref: '#/components/schemas/OrganisationRequest'
responses:
'200':
description: Reply with requested company data.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OrganisationResponse'
'400':
$ref: '#/components/responses/WrongIdentifier'
'401':
$ref: '#/components/responses/WrongToken'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/MissingData'
default:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- OAuth2:
- 'foretagsinformation:read'
- default:
- 'foretagsinformation:read'
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/personer:
post:
tags:
- organisationsinformation
summary: Retrieve data about a person
description: With this operation you can retrieve data about a person.
parameters:
- name: X-Request-Id
in: header
description: >-
Client generated ID to call the API. In case of error this will be
sent in the attribute `requestId` or as a header attribute.
required: false
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
requestBody:
description: >-
An object to specify `identitetsbeteckning` (personal identity number)
and fields to specify the information objects you want in the answer.
Possible information objects are `ORGANISATIONSENGAGEMANG` (Showing a
person’s assignments in companies), `PERSONLIG_KONKURS` (personal
bankruptcy), `BITRADESFORBUD` (prohibition of financial assistance),
`NARINGSFORBUD` (trade ban (prohibition to carry on business)).
content:
application/json:
schema:
$ref: '#/components/schemas/PersonRequest'
responses:
'200':
description: Reply with requested personal data.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/PersonResponse'
'400':
$ref: '#/components/responses/WrongIdentifier'
'401':
$ref: '#/components/responses/WrongToken'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/MissingData'
default:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- OAuth2:
- 'foretagsinformation:read'
- default:
- 'foretagsinformation:read'
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/firmateckningsalternativ:
post:
tags:
- organisationsinformation
summary: Retrieve signatory options for a company officer in a company
description: >-
This operation retrieves the alternatives on signatory power for a
company officer in combination with a company.
parameters:
- name: X-Request-Id
in: header
description: >-
Client generated ID to call the API. In case of error this will be
sent in the error message.
required: false
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
requestBody:
description: >-
Identity of a company officer and of a company. A company officer can
be a legal entity or a physical person.
content:
application/json:
schema:
$ref: '#/components/schemas/FirmateckningsalternativRequest'
required: true
responses:
'200':
description: Reply with requested alternatives on signatory power.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/FirmateckningsalternativResponse'
'400':
$ref: '#/components/responses/WrongIdentifier'
'401':
$ref: '#/components/responses/WrongToken'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/MissingData'
default:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- OAuth2:
- 'foretagsinformation:read'
- default:
- 'foretagsinformation:read'
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/arenden:
post:
tags:
- organisationsinformation
summary: Retrieve data about a case or all cases of a company
description: >-
This operation retrieves either data about a specific case or all cases
of a company depending on how the request is designed. In the latter
option, it is also possible to specify a time interval to limit the
response.
parameters:
- name: X-Request-Id
in: header
description: >-
Client generated ID to call the API. In case of error this will be
sent in the error message.
required: false
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
requestBody:
description: >-
An object to specify `ärendenummer` (case number) or
`identitetsbeteckning` (company registration number). In the latter
option optionally together with a time interval consisting of from-
and/or to dates (`fromdatum` and `tomdatum`).
content:
application/json:
schema:
$ref: '#/components/schemas/ArendeRequest'
required: true
responses:
'200':
description: >-
Reply with requested case data or all cases (with or without a
specific time interval) of a requested company.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ArendeResponse'
'400':
$ref: '#/components/responses/WrongIdentifier'
'401':
$ref: '#/components/responses/WrongToken'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/MissingData'
default:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- OAuth2:
- 'foretagsinformation:read'
- default:
- 'foretagsinformation:read'
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/aktiekapitalforandringar:
post:
tags:
- organisationsinformation
summary: >-
Retrieve data about changes in share capital that has occurred in a
company
description: >-
This operation retrieves data about historical changes of share capital
in a company. It is also possible to specify a time interval to limit
the response.
parameters:
- name: X-Request-Id
in: header
description: >-
Client generated ID to call the API. In case of error this will be
sent in the error message.
required: false
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
requestBody:
description: >-
An object to specify `identitetsbeteckning` (company registration
number). Optionally together with a time interval consisting of from-
and/or to dates (`fromdatum` and `tomdatum`).
content:
application/json:
schema:
$ref: '#/components/schemas/AktiekapitalforandringRequest'
required: true
responses:
'200':
description: >-
Reply with requested changes of share capital (with or without a
specific time interval) of a requested company.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/AktiekapitalforandringResponse'
'400':
$ref: '#/components/responses/WrongIdentifier'
'401':
$ref: '#/components/responses/WrongToken'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/MissingData'
default:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- OAuth2:
- 'foretagsinformation:read'
- default:
- 'foretagsinformation:read'
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/organisationsengagemang:
post:
tags:
- organisationsinformation
summary: >-
Retrieve data about an individual’s or a company’s assignments in other
companies.
description: >-
This operation retrieves data about an individual’s or a company’s
assignments in other companies.
parameters:
- name: X-Request-Id
in: header
description: >-
Client generated ID to call the API. In case of error this will be
sent in the error message.
required: false
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
requestBody:
description: >-
An object to specify `identitetsbeteckning` (company registration
number or personal identity number). Optionally together with
pagination, filter and sort parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/OrganisationsengagemangRequest'
required: true
responses:
'200':
description: >-
Reply with the individual’s or a company’s assignments in other
companies.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/OrganisationsengagemangResponse'
'400':
$ref: '#/components/responses/WrongIdentifier'
'401':
$ref: '#/components/responses/WrongToken'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/MissingData'
default:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- OAuth2:
- 'foretagsinformation:read'
- default:
- 'foretagsinformation:read'
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
/isalive:
get:
tags:
- ping
summary: API-status
description: With this operation you can check to see that the API is up and running.
responses:
'200':
description: OK
'503':
description: Server Unavailable
default:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- OAuth2:
- 'foretagsinformation:monitor'
- default:
- 'foretagsinformation:monitor'
x-auth-type: Application & Application User
x-throttling-tier: Unlimited
components:
schemas:
OrganisationRequest:
title: OrganisationRequest
required:
- identitetsbeteckning
type: object
properties:
identitetsbeteckning:
type: string
description: Company registration number (`Identitetsbeteckning`).
namnskyddslopnummer:
type: string
description: >
"Namnskyddslopnummer" is used to separate companies for organisation
types that can have more than one company on the same
"identitetsbeteckning" (company registration number). For example
Enskild näringsverksamhet can have more than one company with
different names on the same company registration number. If this
parameter is left out the API will reply with all companies on that
company registration number. Namnskyddslopnummer may also be padded
with leading zeroes, for example "1" may be padded as "001".
example: '1'
organisationInformationsmangd:
type: array
description: >-
The information objects wanted in the answer. If this is left out
the response will just include "identitetsbeteckning",
"namnskyddslopnummer", "organisationsnamn", "organisationsform" and
"organisationsstatusar".
items:
type: string
enum:
- AKTIEINFORMATION
- FIRMATECKNING
- FUNKTIONARER
- HEMVISTKOMMUN
- ORGANISATIONSADRESSER
- ORGANISATIONSDATUM
- ORGANISATIONSENGAGEMANG
- RAKENSKAPSAR
- SAMTLIGA_ORGANISATIONSNAMN
- TILLSTAND
- VERKSAMHETSBESKRIVNING
- OVRIG_ORGANISATIONSINFORMATION
- ORGANISATIONSMARKERINGAR
- BESTAMMELSER
- VAKANSER_OCH_UPPLYSNINGAR
- EKONOMISK_PLAN
- UTLANDSK_FILIALAGANDE_ORGANISATION
- FINANSIELLA_RAPPORTER
tidpunkt:
type: string
description: >-
Timestamp for historical data of the retrieved companies. For
example `2025-02-25T12:00:00`.
description: Object to retrieve data about a company.
OrganisationResponse:
title: OrganisationResponse
type: array
description: >-
The companies returned in the response. For some company types such as
Enskild näringsverksamhet, there may be more than one company returned
in the response.
items:
$ref: '#/components/schemas/OrganisationType'
OrganisationType:
title: OrganisationType
type: object
properties:
identitet:
$ref: '#/components/schemas/Identitet'
namnskyddslopnummer:
type: integer
description: >
"Namnskyddslopnummer" is used to separate companies for organisation
types that can have more than one company on the same
"identitetsbeteckning" (company registration number). For example
Enskild näringsverksamhet can have more than one company with
different names on the same company registration number.
example: 2
arende:
$ref: '#/components/schemas/OrganisationArende'
organisationsnamn:
$ref: '#/components/schemas/Organisationsnamn'
organisationsform:
$ref: '#/components/schemas/KodKlartext'
organisationsstatusar:
type: array
description: >-
Code, text and type for the Company status and the registration date
for the status. If typ is 'AvregistreradOrganisationstyp' the
company is no longer active. If typ is
'AvvecklingsOmstruktureringsforfarande' the company is in a process
of status change.
items:
$ref: '#/components/schemas/KodKlartextDatum'
organisationsdatum:
title: organisationsdatum
type: object
properties:
registreringsdatum:
type: string
description: Date the company was registered.
format: date
bildatDatum:
type: string
description: Date the company was founded.
format: date
description: Different dates regarding the company.
hemvistkommun:
title: hemvistkommun
type: object
properties:
typ:
type: string
description: Type of domicile.
lanForHemvistkommun:
$ref: '#/components/schemas/KodKlartext'
kommun:
$ref: '#/components/schemas/KodKlartext'
description: Company domicile. `Län` and `Kommun` in code and text.
rakenskapsar:
$ref: '#/components/schemas/Rakenskapsar'
verksamhetsbeskrivning:
type: string
description: >-
Description of the business activities. Can be a lot of text in some
cases.
organisationsadresser:
title: organisationsadresser
type: object
properties:
postadress:
$ref: '#/components/schemas/Postadress'
epostadress:
type: string
description: Email to the company.
description: The company's contact information. Postal address and email address.
firmateckning:
title: firmateckning
type: object
properties:
kodad:
$ref: '#/components/schemas/Kodad'
klartext:
type: string
description: Signatory power in text.
prokuratext:
type: string
description: Power of procuration in text.
description: Information about signatory power
samtligaOrganisationsnamn:
type: array
description: All business names.
items:
$ref: '#/components/schemas/Organisationsnamnsinformation'
funktionarer:
type: array
description: Company officers.
items:
$ref: '#/components/schemas/Funktionarsinformation'
antalValdaFunktionarer:
type: object
properties:
ledamoter:
type: number
suppleanter:
type: number
description: Specifies the number of officers designated by the company.
aktieinformation:
$ref: '#/components/schemas/Aktieinformation'
organisationsengagemang:
$ref: '#/components/schemas/Organisationsengagemang'
tillstand:
title: tillstand
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
datum:
type: string
description: Permit concession date.
format: date
aterkallatDatum:
type: string
description: Permit withdrawn this date.
format: date
forlangtDatum:
type: string
description: Permit extended this date.
format: date
forverkatDatum:
type: string
description: Permit forfeited this date.
format: date
description: Information about a company's permits
ovrigOrganisationinformation:
title: ovrigOrganisationinformation
type: object
properties:
externaAnteckningar:
type: string
description: Notations about the organisation in free text.
ovrigaRegisteruppgifter:
type: string
description: Other registration data.
description: Other information about the organisation.
organisationsmarkeringar:
title: organisationsmarkeringar
type: array
description: Markings on the organisation.
items:
$ref: '#/components/schemas/KodKlartext'
bestammelser:
title: bestammelser
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
godkannandeKravs:
type: boolean
description: >-
Markings if the articles of association must be approved by for
example Swedish Financial Supervisory Authority.
kungorelsedatum:
type: string
description: Announcement date.
format: date
registreringsdatum:
type: string
description: Registration date.
format: date
antagetDatum:
type: string
description: Date for adoption.
format: date
kallelsesatt:
type: string
description: Summons to shareholder's meeting.
godkandAvInstanser:
type: array
items:
$ref: '#/components/schemas/GodkandAvInstans'
styrelsegranser:
$ref: '#/components/schemas/Styrelsegrans'
stammotidManader:
type: array
description: >-
Months for shareholders' or members' meeting. For example JAN,
FEB for January and February.
items:
type: string
stammotidSenastManad:
type: string
description: Latest month for shareholders' or members' meeting.
stammotidInomSexManader:
type: boolean
description: >-
Marking that the shareholders' or members' meeting will be held
within six months after the end of the financial year.
frivilligaBestammelser:
type: array
items:
$ref: '#/components/schemas/FrivilligBestammelse'
fritext:
type: string
description: Free text information about the regulations of the organisation
description: Regulations for the organisation.
vakanserOchUpplysningar:
title: vakanserOchUpplysningar
type: object
properties:
vakansOchUpplysning:
type: array
items:
$ref: '#/components/schemas/VakansOchUpplysning'
fritext:
type: string
description: Free text information about the organisation.
description: Vacancies and other information about the organisation.
ekonomiskPlan:
title: ekonomiskPlan
type: object
properties:
registreradDatum:
type: string
description: First registration date for the financial plan.
format: date
senastRegistreradDatum:
type: string
description: Last registration date for the financial plan.
format: date
forenkladRegistreradDatum:
type: string
description: Registration date for the simplified financial plan.
format: date
description: Information about financial plan for company form BRF
utlandskFilialagandeOrganisation:
title: utlandskFilialagandeOrganisation
type: object
properties:
identitet:
$ref: '#/components/schemas/Identitet'
angivetEuid:
type: string
description: The EU identity number.
organisationsnamn:
$ref: '#/components/schemas/Organisationsnamn'
registreringsdatum:
type: string
description: Registration date.
format: date
verksamhetsbeskrivning:
type: string
description: Description of the business activities.
sate:
type: string
description: Domicile for the company.
postadress:
$ref: '#/components/schemas/Postadress'
rakenskapsar:
$ref: '#/components/schemas/Rakenskapsar'
ejVerifieratOrganisationsregister:
type: object
properties:
organisationsregister:
type: string
land:
$ref: '#/components/schemas/KodKlartext'
description: Foreign companies registration office.
aktieinformation:
$ref: '#/components/schemas/AktiekapitalUtlandskt'
funktionarer:
type: array
items:
$ref: '#/components/schemas/FunktionarUtlandsk'
description: Information about a foreign company having a Swedish branch.
finansiellaRapporter:
title: finansiellaRapporter
type: array
description: Information about a company's financial reports
items:
title: finansiellRapport
type: object
properties:
arende:
type: object
properties:
arendenummer:
type: string
description: >-
Case number of the company's last completed case for a
financial report. This is the case number when the dataset
for the financial report response was updated.
avslutatTidpunkt:
type: string
description: >-
The timestamp when the company's last case for a financial
report was completed. This is the timestamp when the
dataset for the financial report response was updated.
description: >-
Arende is holding information about the company's last
completed case for a financial report, such as case number and
timestamp when the financial report case was completed.
rapporter:
type: array
description: Reports.
items:
$ref: '#/components/schemas/Rapporter'
description: >-
Information about a case and the reports connected to the case.
One case can contain one or several reports.
Aktiegranser:
title: Aktiegranser
type: object
properties:
aktiekapitalGranser:
$ref: '#/components/schemas/LagstHogstKapital'
antalAktierGranser:
$ref: '#/components/schemas/LagstHogstAntal'
valuta:
type: string
description: |
The currency can have the following value:
* `SEK`: Swedish Krona
* `EUR`: Euro
enum:
- SEK
- EUR
description: >-
Information about minimum and maximum share capital and minimun and
maximum number of shares.
AktiekapitalUtlandskt:
title: AktiekapitalUtlandskt
type: object
properties:
belopp:
type: number
description: Amount.
valuta:
$ref: '#/components/schemas/KodKlartext'
inbetaltBelopp:
type: number
description: Amount paid.
description: Information about share capital for foreign company
Aktieslag:
title: Aktieslag
type: object
properties:
namn:
type: string
description: Name of the class of shares.
example: A
antal:
type: integer
description: Number of shares for the class of shares.
format: int64
example: 1000
aktieslagGranser:
$ref: '#/components/schemas/LagstHogstAntal'
rostvarde:
type: string
description: Number of votes per share for the class of shares.
example: '1'
AktieslagUtanAktieslagGranser:
title: AktieslagUtanAktieslagGranser
type: object
properties:
namn:
type: string
description: Name of the class of shares.
example: A
antal:
type: integer
description: Number of shares for the class of shares.
format: int64
example: 1000
rostvarde:
type: string
description: Number of votes per share for the class of shares.
example: '1'
BeloppValuta:
title: BeloppValuta
type: object
properties:
belopp:
multipleOf: 0.000001
type: number
description: Amount.
example: 12000
valuta:
type: string
description: |
The currency can have the following value:
* `SEK`: Swedish Krona
* `EUR`: Euro
enum:
- SEK
- EUR
description: Information about amount and currency.
Firmateckningskombination:
type: array
description: >-
The signatory power can consist of more than one rule for signatory
power. The rules for signatory power shall be read in the order they
appear.
items:
$ref: '#/components/schemas/Firmateckningsregel'
Firmateckningsregel:
title: firmateckningsregel
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
ordning:
type: number
description: Sort order for rules in signatory powers.
example: 1
funktionarsroller:
type: array
description: >-
The roles the company officers for signatory power have that the
rule is pointing to.
items:
$ref: '#/components/schemas/KodKlartext'
funktionarer:
type: array
description: >-
The company officers for signatory power that the rule is pointing
to.
items:
$ref: '#/components/schemas/Funktionar'
FrivilligBestammelse:
title: FrivilligBestammelse
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
datum:
type: string
format: date
description: >-
Voluntary regulation. Type of regulation (typ) and date of voluntary
regulation (datum).
Funktionar:
title: Funktionar
type: object
properties:
personnamn:
$ref: '#/components/schemas/Personnamn'
organisationsnamn:
$ref: '#/components/schemas/Organisationsnamn'
identitet:
$ref: '#/components/schemas/Identitet'
Funktionarsinformation:
title: Funktionarsinformation
allOf:
- $ref: '#/components/schemas/Funktionar'
- type: object
properties:
funktionarsroller:
type: array
description: The roles the company officer has in the company. Code and text.
items:
$ref: '#/components/schemas/KodKlartext'
postadress:
$ref: '#/components/schemas/Postadress'
representerasAv:
type: object
properties:
personnamn:
$ref: '#/components/schemas/Personnamn'
identitet:
$ref: '#/components/schemas/Identitet'
description: >-
The name and the identity of the auditor. Only populated if the
main auditor is a company.
insats:
type: string
description: >-
Contributed capital. Only applicable for the companies with
company form Kommanditbolag.
anteckning:
type: string
description: Notations done for the company officer.
Aktieinformation:
type: object
properties:
aktiekapital:
$ref: '#/components/schemas/BeloppValuta'
antalAktier:
type: integer
description: Number of shares in total.
format: int64
example: 1200
aktiegranser:
$ref: '#/components/schemas/Aktiegranser'
aktieslag:
type: array
description: Information about class of shares.
items:
$ref: '#/components/schemas/Aktieslag'
fritext:
type: string
description: Free text about share capital.
example: >-
Antalet aktier av respektive slag får motsvara högst hela antalet
aktier i bolaget.
kvotvarde:
$ref: '#/components/schemas/BeloppValuta'
nedsattningPagar:
type: boolean
description: Reduction of share capital in progress.
description: Information about share capital.
FunktionarUtlandsk:
title: FunktionarUtlandsk
type: object
properties:
namn:
type: string
description: Name of the company officer.
idnummer:
type: string
description: Identitification number of the company officer.
postadress:
$ref: '#/components/schemas/Postadress'
funktion:
type: string
description: The role the company officer have in the company.
description: Information about company officers in a foreign company.
GodkandAvInstans:
title: GodkandAvInstans
type: object
properties:
datum:
type: string
description: Date for approval
format: date
kommunfullmaktigeI:
$ref: '#/components/schemas/KodKlartext'
instans:
$ref: '#/components/schemas/KodKlartext'
fritext:
type: string
description: Free text about the approval
description: >-
A regulations is either approved by a municipality (kommunfullmaktigeI)
or other authority such as Swedish Financial Supervisory (instans).
Identitet:
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
identitetsbeteckning:
type: string
description: Company or personal identity number.
description: The company registration number or personal identity number.
Kodad:
title: Kodad
type: array
description: >-
The information regarding a company’s signatory power. It consist of all
signatory power rules a company have (in code and text) and which of the
company officers a specific rule is pointing to
items:
$ref: '#/components/schemas/Firmateckningskombination'
KodKlartext:
title: KodKlartext
type: object
properties:
kod:
type: string
description: Code for the object.
klartext:
type: string
description: Text for the object.
KodKlartextDatum:
title: KodKlartextDatum
type: object
properties:
kod:
type: string
description: Code for the object.
klartext:
type: string
description: Text for the object.
typ:
type: string
description: Type for the object.
format: string
datum:
type: string
description: Date for the object.
format: date
BeslutType:
title: BeslutType
type: object
properties:
instanstyp:
$ref: '#/components/schemas/KodKlartext'
beslutsdatum:
type: string
format: date
LagstHogstAntal:
title: LagstHogstAntal
type: object
properties:
lagst:
type: integer
description: 'Minimum number of something, for example shares.'
format: int64
example: 1000
hogst:
type: integer
description: 'Maximum number of something, for example shares.'
format: int64
example: 10000
LagstHogstKapital:
title: LagstHogstKapital
type: object
properties:
lagst:
multipleOf: 0.000001
type: number
description: 'Minimum capital of something, for example shares.'
example: 25000
hogst:
multipleOf: 0.000001
type: number
description: 'Maximum capital of something, for example shares.'
example: 100000
Organisationsengagemang:
type: array
description: Companies in which the person or company is a company officer.
items:
title: organisationsengagemang
type: object
properties:
organisation:
title: organisation
type: object
properties:
identitet:
$ref: '#/components/schemas/Identitet'
namnskyddslopnummer:
type: integer
description: >
"Namnskyddslopnummer" is used to separate companies for
organisation types that can have more than one company on the
same "identitetsbeteckning" (company registration number). For
example Enskild näringsverksamhet can have more than one
company with different names on the same company registration
number.
example: 2
personnamn:
$ref: '#/components/schemas/Personnamn'
organisationsnamn:
$ref: '#/components/schemas/Organisationsnamn'
organisationsform:
$ref: '#/components/schemas/KodKlartext'
organisationsstatusar:
type: array
items:
$ref: '#/components/schemas/KodKlartextDatum'
description: Company in which the person or the company is a company officer.
funktionar:
$ref: '#/components/schemas/Funktionarsinformation'
Organisationsnamn:
title: Organisationsnamn
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
namn:
type: string
description: The registered business name.
description: Business name.
Organisationsnamnsinformation:
title: Organisationsnamnsinformation
description: >-
An object to describe the business names. Registreringslan is the main
county of registration and registreringFlerLan is the secondary counties
of registration.
allOf:
- $ref: '#/components/schemas/Organisationsnamn'
- type: object
properties:
registreringsdatum:
type: string
description: >-
Date when the company’s secondary business name or business name
in translation was registered.
format: date
verksamhetsbeskrivningSarskiltForetagsnamn:
type: string
description: >-
Description of the business activities for the secondary
business name.
beslutAvStamma:
type: boolean
description: Marking if the decision was made in a shareholders’ meeting.
iBestammelser:
type: boolean
description: >-
If the decision was made in a shareholders’ meeting this shows
in what type of regulation the name is registered.
registreringslan:
$ref: '#/components/schemas/KodKlartext'
registreringFlerLan:
type: array
items:
$ref: '#/components/schemas/KodKlartext'
Personnamn:
title: Personnamn
type: object
properties:
fornamn:
type: string
description: The registered first name.
efternamn:
type: string
description: The registered surname.
Postadress:
title: Postadress
type: object
properties:
coAdress:
type: string
description: C/o address.
adress:
type: string
description: Postal address.
postnummer:
type: string
description: Postal code.
postort:
type: string
description: Postal town.
adressrad1:
type: string
description: First address line for foreign companies.
adressrad2:
type: string
description: Second address line for foreign companies.
land:
$ref: '#/components/schemas/KodKlartext'
description: Registered postal address.
Rapporter:
title: Rapporter
type: object
properties:
rapporteringsperiod:
type: object
properties:
periodFrom:
type: string
description: The period for the financial report applies from this date.
periodTom:
type: string
description: The period for the financial report applies to this date.
description: Period for the financial report.
rapportTyp:
$ref: '#/components/schemas/KodKlartext'
ankomDatum:
type: string
description: Arrival date.
handlaggningAvslutadDatum:
type: string
description: Date when the administrate process completed.
registreradDatum:
type: string
description: Registration date for the financial report.
bolagsstammansForlangningDatum:
type: string
description: The shareholders' meetings extension date.
innehallerKoncernredovisning:
type: boolean
description: Information if the financial report contains consolidated accounts.
vinstutdelning:
$ref: '#/components/schemas/Vinstutdelning'
description: The company's financial reports.
Rakenskapsar:
title: rakenskapsar
type: object
properties:
rakenskapsarInleds:
type: string
description: >-
Month and first day of the month when the financial year starts.
January the first is JAN01 and so on. For some company forms the
financial year can start in the middle of a month DEC16.
rakenskapsarAvslutas:
type: string
description: >-
Month and last day of the month when the financial year ends.
January the last is JAN31. If the financial year ends last day of
February, this is always FEB28 even if February some years has 29
days. For some company forms the financial year can end in the
middle of a month DEC15.
description: Financial year of the company.
Styrelsegrans:
title: Styrelsegrans
type: object
properties:
ledamoter:
$ref: '#/components/schemas/LagstHogstAntal'
suppleanter:
$ref: '#/components/schemas/LagstHogstAntal'
description: >-
Minimum and maximum number of board members (ledamoter) and deputy board
members (suppleanter).
VakansOchUpplysning:
title: VakansOchUpplysning
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartextDatum'
description: Type of vacancy (typ) and date of vacancy (datum).
Vinstutdelning:
title: Vinstutdelning
type: object
properties:
beslutadDatum:
type: string
description: Date of decision.
valuta:
$ref: '#/components/schemas/KodKlartext'
belopp:
type: number
description: Amount.
description: 'Distribution of profits. Date of decision, currency and amount.'
PersonRequest:
title: PersonRequest
required:
- identitetsbeteckning
type: object
properties:
identitetsbeteckning:
type: string
description: The `identitetsbeteckning` (personal identity number).
personInformationsmangd:
type: array
description: >-
The information objects wanted in the response. If this is left out
the response will just include "identitetsbeteckning" and "namn".
items:
type: string
enum:
- ORGANISATIONSENGAGEMANG
- PERSONLIG_KONKURS
- BITRADESFORBUD
- NARINGSFORBUD
description: Object to retrieve personal data.
PersonResponse:
$ref: '#/components/schemas/Person'
Person:
title: Person
type: object
properties:
identitet:
$ref: '#/components/schemas/Identitet'
personnamn:
$ref: '#/components/schemas/Personnamn'
organisationsengagemang:
$ref: '#/components/schemas/Organisationsengagemang'
personligKonkurs:
type: array
description: Information about personal bankruptcy.
items:
title: personligKonkurs
type: object
properties:
dodsbonummer:
type: string
description: >-
Identification number of an estate of a decedent. The
identification number is registered by Skatteverket.
insolvensforfarande:
title: personligKonkursInsolvensforfarande
type: object
properties:
huvud:
type: string
description: >-
Main, the most common type of insolvency. "true" or
"false".
sekundart:
type: string
description: >-
Secondary, subordinate to main insolvency. "true" or
"false".
territorielltBegransat:
type: string
description: >-
Territorial, only regarding assets where the person has
his/her residence. "true" or "false".
description: >-
There can be three types of insolvency, main, secondary or
territorially limited.
process:
title: personligKonkursProcess
type: object
properties:
inledd:
title: personligKonkursProcessInledd
type: object
properties:
malnummer:
type: string
description: Case number.
datum:
type: string
description: Date when the personal bankruptcy proceedings started.
format: date
overklaganSenastDatum:
type: string
description: >-
Last date to appeal against personal bankruptcy
proceedings started.
format: date
anmalanFordringarSenastDatum:
type: string
description: Last date to file a claim.
format: date
beslutsinstans:
title: personligKonkursProcessInleddBeslutsinstans
type: object
properties:
svensk:
title: personligKonkursProcessInleddBeslutsinstansSvensk
allOf:
- $ref: '#/components/schemas/KodKlartext'
utlandsk:
title: >-
personligKonkursProcessInleddBeslutsinstansUtlandsk
type: object
properties:
namn:
type: string
description: The name of the foreign court.
land:
$ref: '#/components/schemas/KodKlartext'
description: >-
The court of law that took the decision to commence
personal bankruptcy proceedings. Swedish or foreign
(code and text).
overklagande:
title: personligKonkursOverklagande
type: object
properties:
beslutsinstans:
title: personligKonkursOverklagandeBeslutsinstans
type: object
properties:
svensk:
title: >-
personligKonkursOverklagandeBeslutsinstansSvensk
allOf:
- $ref: '#/components/schemas/KodKlartext'
utlandsk:
title: >-
personligKonkursOverklagandeBeslutsinstansUtlandsk
type: object
properties:
namn:
type: string
description: The name of the foreign court.
land:
$ref: '#/components/schemas/KodKlartext'
description: >-
The court of law that took the decision to appeal
personal bankruptcy proceedings. Swedish or
foreign (code and text).
description: >-
Information about appeal against the decision to start
personal bankruptcy proceedings.
description: Information about personal bankruptcy proceedings started.
avslutad:
title: personligKonkursAvslutad
type: object
properties:
datum:
type: string
description: Date of completion.
format: date
description: >-
Information about completion of personal bankruptcy
proceedings.
upphavd:
title: personligKonkursUpphavd
type: object
properties:
malnummer:
type: string
description: Case number.
datum:
type: string
description: Date of reversion.
format: date
beslutsinstans:
title: personligKonkursUpphavdBeslutsinstans
type: object
properties:
svensk:
title: personligKonkursUpphavdBeslutsinstansSvensk
allOf:
- $ref: '#/components/schemas/KodKlartext'
utlandsk:
title: personligKonkursUpphavdBeslutsinstansUtlandsk
type: object
properties:
namn:
type: string
description: The name of the foreign court.
land:
$ref: '#/components/schemas/KodKlartext'
description: >-
The court of law that took the decision to reverse
personal bankruptcy proceedings. Swedish or foreign
(code and text).
overklagande:
title: personligKonkursUpphavdOverklagande
type: object
properties:
datum:
type: string
description: >-
Date of appeal against reversion of personal
bankruptcy proceedings.
format: date
beslutsinstans:
title: personligKonkursUpphavdOverklagandeBeslutsinstans
type: object
properties:
svensk:
title: >-
personligKonkursUpphavdOverklagandeBeslutsinstansSvensk
allOf:
- $ref: '#/components/schemas/KodKlartext'
utlandsk:
title: >-
personligKonkursUpphavdOverklagandeBeslutsinstansUtlandsk
type: object
properties:
namn:
type: string
description: The name of the foreign court.
land:
$ref: '#/components/schemas/KodKlartext'
description: >-
The court of law that took the decision to appeal
against reversion of personal bankruptcy
proceedings. Swedish or foreign (code and text).
description: >-
Information about appeal against reversion of personal
bankruptcy proceedings.
description: >-
Information about reversion of personal bankruptcy
proceedings.
description: >-
Information about the personal bankruptcy proceedings and
case.
konkursforvaltare:
title: personligKonkursKonkursforvaltare
type: object
properties:
personnamn:
$ref: '#/components/schemas/Personnamn'
postadress:
$ref: '#/components/schemas/Postadress'
description: >-
Information about official receiver of the personal bankruptcy
proceedings.
bitradesforbud:
title: bitradesforbud
type: object
properties:
fritext:
type: string
description: Free text about prohibition of financial assistance.
slutligt:
title: bitradesforbudSlutgiltigt
type: object
properties:
from:
type: string
description: >-
The definite prohibition of financial assistance applies
from this date.
format: date
tom:
type: string
description: >-
The definite prohibition of financial assistance applies to
this date.
format: date
description: Information about definite prohibition of financial assistance.
tillfalligt:
title: bitradesforbudTillfalligt
type: object
properties:
from:
type: string
description: >-
The reversion of prohibition of financial assistance applies
from this date.
format: date
description: >-
Information about provisional prohibition of financial
assistance.
beslut:
title: bitradesforbudBeslut
type: object
properties:
typ:
type: string
description: Type of decision.
datum:
type: string
description: Decision date.
format: date
beslutsinstans:
$ref: '#/components/schemas/KodKlartext'
description: >-
Information about decision of prohibition of financial
assistance.
description: Information about prohibition of financial assistance.
naringsforbud:
title: naringsforbud
type: object
properties:
fritext:
type: string
description: Free text about trade ban.
slutligt:
title: naringsforbudSlutligt
type: object
properties:
from:
type: string
description: The definite trade ban applies from this date.
format: date
tom:
type: string
description: The definite trade ban applies to this date.
format: date
description: Information about definite trade ban.
tillfalligt:
title: naringsforbudTillfalligt
type: object
properties:
from:
type: string
description: The provisional trade ban applies from this date.
format: date
description: Information about provisional trade ban.
beslut:
title: naringsforbudBeslut
type: object
properties:
typ:
type: string
description: Type of decision.
datum:
type: string
description: Date for decision.
format: date
beslutsinstans:
$ref: '#/components/schemas/KodKlartext'
description: Information about decision of trade ban.
undantag:
title: naringsforbudUndantag
type: object
properties:
from:
type: string
description: The exception of trade ban applies from this date.
format: date
tom:
type: string
description: The exception of trade ban applies to this date.
format: date
aterkallatDatum:
type: string
description: The exception of trade ban was withdrawn this date.
format: date
description: Information about exception of trade ban.
avveckling:
type: string
description: Date for close down of trade ban.
format: date
description: Information about trade ban (prohibition to carry on business).
FirmateckningsalternativRequest:
title: FirmateckningsalternativRequest
required:
- funktionarIdentitetsbeteckning
- organisationIdentitetsbeteckning
type: object
properties:
funktionarIdentitetsbeteckning:
type: string
description: >-
The `funktionarIdentitetsbeteckning` (identity number of the company
officer). A company officer can be a physical person or a legal
entity.
organisationIdentitetsbeteckning:
type: string
description: >-
The `organisationIdentitetsbeteckning` (company registration
number).
FirmateckningsalternativResponse:
title: FirmateckningsalternativResponse
required:
- firmateckningInformation
type: object
properties:
firmateckningInformation:
type: array
description: >-
The company or companies returned in the response. For some company
types such as Enskild näringsverksamhet, there may be more than one
company returned in the response.
items:
title: firmateckningInformation
type: object
properties:
funktionar:
$ref: '#/components/schemas/Funktionarsinformation'
firmateckningOrganisation:
$ref: '#/components/schemas/FirmateckningOrganisation'
firmateckningssvar:
$ref: '#/components/schemas/Firmateckningssvar'
description: >-
Information about the the company officer, the company and information
if the company officer has signatory power is in
`firmateckningInformation`.
FirmateckningOrganisation:
title: FirmateckningOrganisation
type: object
properties:
identitet:
$ref: '#/components/schemas/Identitet'
namnskyddslopnummer:
type: integer
description: >
"Namnskyddslopnummer" is used to separate companies for organisation
types that can have more than one company on the same
"identitetsbeteckning" (company registration number). For example
Enskild näringsverksamhet can have more than one company with
different names on the same company registration number.
example: 1
organisationsnamn:
$ref: '#/components/schemas/Organisationsnamn'
organisationsform:
$ref: '#/components/schemas/KodKlartext'
organisationsstatusar:
type: array
description: >-
Company status in code and text and the date for the registration of
the status.
items:
$ref: '#/components/schemas/KodKlartextDatum'
inneliggandeArenden:
type: object
properties:
antal:
type: integer
description: Number of pending registration matters on the company.
description: Information about pending registration matters on the company.
Firmateckningssvar:
title: Firmateckningssvar
type: object
properties:
utfall:
type: string
description: >
* `JA`: The company officer has signatory power.
* Observe that there can be unresolved registration errands on the company that can be about to change the rules on who is having signatory power.
* `NEJ`: The company officer does NOT have signatory power. The
reason is one of the below:
* The company does not exist or is deregistered.
* The company officer has no role in this company.
* The company officer has a role in this company but the company officer has no signatory power.
enum:
- JA
- NEJ
firmateckningsutfallJaSvar:
type: array
description: >-
If the answer is `JA` you get a list of all possible alternatives
the company officer has regarding signatory power. Every alternative
is a valid option for signatory power. The rule for signatory power
for the different options is also shown in
`FirmateckningsutfallOrsak`.
items:
$ref: '#/components/schemas/FirmateckningsutfallJa'
firmateckningsutfallNejSvar:
type: object
properties:
alternativ:
type: string
description: >
* `EJ_AKTIV_ORGANISATION`: The company does not exist or is
deregistered.
* `EJ_FUNKTIONAR`: The company officer has no role in this
company.
* `EJ_FIRMATECKNARE`: The company officer has a role in this
company but the company officer does not have signatory power.
enum:
- EJ_AKTIV_ORGANISATION
- EJ_FUNKTIONAR
- EJ_FIRMATECKNARE
description: If the answer is `NEJ` you get the reason for that answer.
example: EJ_AKTIV_ORGANISATION
description: >
Answer if the company officer has signatory power, `JA` (Yes) or `NEJ`
(No). If the answer is `JA` you get a list under
`firmateckningsutfallJaLista` if the company officer has signatory power
`ENSAM` (alone), `LOPANDE` (The managing director can sign on behalf of
the company in the course of normal business activities) or
`TILLSAMMANS` (together with other company officers). If the answer is
`TILLSAMMANS` you get a list of other company officers that the inquired
company officer has to sign with. If the answer is `FULLMAKT`, the
company officer has signatory power with a power of attorney.
Bolagsverket has not the power of attorney registered.
FirmateckningsutfallJa:
title: FirmateckningsutfallJa
required:
- alternativ
type: object
properties:
alternativ:
type: string
description: >
* `ENSAM`: The company officer has signatory power alone
* `LOPANDE`: The managing director is entitled to sign on behalf of
the company in the course of normal business activities.
* `TILLSAMMANS`: The company officer has signatory power together
with other company officers listed below.
* `FULLMAKT`: The company officer has signatory power with a power
of attorney. Bolagsverket has not the power of attorney registered.
example: TILLSAMMANS
enum:
- ENSAM
- LOPANDE
- TILLSAMMANS
- FULLMAKT
firmateckningsutfallOrsak:
$ref: '#/components/schemas/FirmateckningsutfallOrsak'
namnKanEjListas:
type: boolean
description: >-
If the answer is `TILLSAMMANS` but the company officers that needs
to be listed cannot be listed because the API does not support that
rule for signatory power, it is shown here.
example: false
firmateckningsutfallJatillsammansAlternativ:
title: firmateckningsutfallJatillsammansAlternativ
type: array
description: >-
The different combination of names that can give this `TILLSAMMANS`
answer.
items:
type: array
description: >-
One or more company officers that is included in the signatory
options if the alternative is `TILLSAMMANS`. All company officers
listed here must sign in order for the signature to be correct.
items:
$ref: '#/components/schemas/Funktionar'
description: >-
If the answer in "alternativ" is `ENSAM` the company officer has
signatory power alone. If the answer is `TILLSAMMANS` the company
officer has signatory power together with other company officers. If the
company officer has the role managing director the answer can be
`LOPANDE` which means that the VD can sign on behalf of the company in
the course of normal business activities. If the answer is `FULLMAKT`,
the company officer has signatory power with a power of attorney.
Bolagsverket has not the power of attorney registered.
FirmateckningsutfallOrsak:
title: FirmateckningsutfallOrsak
type: object
properties:
firmateckningskombination:
type: array
description: >-
The signatory power can consist of more than one rule for signatory
power. The rules for signatory power shall be read in the order they
appear.
items:
$ref: '#/components/schemas/Firmateckningsregel'
ArendeRequest:
title: ArendeRequest
type: object
oneOf:
- $ref: '#/components/schemas/RequestArendenummer'
- $ref: '#/components/schemas/RequestOrganisationIdentitetsbeteckning'
RequestArendenummer:
required:
- arendenummer
type: object
properties:
arendenummer:
type: string
description: Case number.
example: 1234/2024
description: >-
The `Arendenummer` (case number). Consists of an `ärendelöpnummer` and
an `ärendeår`, separated by a slash `/`. `ärendeår` will always be with
century (four digits). Example, 2024.
RequestOrganisationIdentitetsbeteckning:
required:
- organisationIdentitetsbeteckning
type: object
properties:
organisationIdentitetsbeteckning:
type: string
description: Company registration number.
example: '5560123456'
fromdatum:
type: string
description: >-
Limit the request for cases that have started or completed from, and
after, this date.
example: '2024-01-01'
tomdatum:
type: string
description: >-
Limit the request for cases that have started or completed to, and
before, this date.
example: '2024-12-31'
description: >-
The `OrganisationIdentitetsbeteckning` (company registration number). It
is also possible to specify a time interval (`from` and/or `tom`).
ArendeResponse:
title: ArendeResponse
type: array
description: >-
Information about the case or all cases of a company is in
`arendeInformation`.
items:
$ref: '#/components/schemas/ArendeType'
ArendeType:
title: ArendeType
type: object
properties:
skapatTidpunkt:
type: string
description: Time when the case was created.
example: '2008-05-02T13:48:03.580+02:00'
avslutatTidpunkt:
type: string
description: Time when the case was completed.
example: '2008-10-20T11:13:26.020+02:00'
arendenummer:
type: string
description: Case number.
example: 210347/2008
atagandeid:
type: string
description: >-
Atagandeid is a technical id used to keep several case numbers at
Bolagsverket toghether. For example registration of a new company
and registration of benificial owner done at the same time.
konsumentreferens:
type: string
description: >-
Consumer reference, used as a case id to keep a case together when
more than one authority is involved and each authority have
different case numbers. Example, registration of a new company from
Verksamt.se
arendeslag:
$ref: '#/components/schemas/KodKlartext'
arendetyp:
$ref: '#/components/schemas/KodKlartext'
arendeaktorer:
type: array
description: >-
The one to whom the case applies. Right now there is always one
arendeaktor but in future versions there can be more than one
arendeaktor.
items:
$ref: '#/components/schemas/Arendeaktorer'
sakfragor:
type: array
description: Sakfraga is holding information about what the case is about.
items:
$ref: '#/components/schemas/Sakfragor'
arendestatus:
$ref: '#/components/schemas/KodKlartext'
handlaggningsstatus:
$ref: '#/components/schemas/KodKlartext'
arendesamband:
$ref: '#/components/schemas/Arendesamband'
description: >-
The case or cases of a company returned in the response. If the request
is on `organisationIdentitetsbeteckning`, there may be more than one
cases returned in the response. Arendeslag is holding information about
if a case is "Verkställighetsärende" (all cases that is being appeal
against or reconcidered) and "Grundärende" (all other cases). Arendetyp
is holding information about type of case. Example, Registration of a
new company. Arendestatus is holding information about if a case is open
or closed. Handläggningsstatus is holding information about the case
administration status. Example, Waiting for additional information.
Arendesamband, Case connection. Used if a case proceeds or continues in
other cases. Arendesambandstyp is holding information about the type of
connection.
Arendeaktorer:
title: Arendeaktorer
type: object
properties:
identitet:
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
identitetsbeteckning:
type: string
description: Identity number.
namn:
type: string
description: Name
arenderoll:
$ref: '#/components/schemas/KodKlartext'
kontaktuppgiftIArende:
type: object
properties:
adressat:
type: string
description: Addressee.
postadress:
$ref: '#/components/schemas/Postadress'
epostadress:
type: string
description: Email.
description: Contact details in the case.
description: >-
The one to whom the case applies. Arenderoll is holding information
about the role the one to whom the case applies have.
Arendesamband:
title: Arendesamband
type: array
description: >-
Case connection. Used if a case proceeds or continues in other cases.
Arendesambandstyp is holding information about the type of connection.
items:
type: object
properties:
utgarFranArendenummer:
type: string
description: Proceeds from this case number.
fortsatterIArendenummer:
type: string
description: Continues in this case number.
arendesambandstyp:
$ref: '#/components/schemas/KodKlartext'
OrganisationArende:
title: Arende
type: object
properties:
arendenummer:
type: string
description: >-
Case number of the company's last completed case. This is the case
number when the dataset in this response was updated.
example: 1234/2024
avslutatTidpunkt:
type: string
description: >-
The timestamp when the company's last case was completed. This is
the timestamp when the dataset in this response was updated.
example: '2000-01-01T00:00:00.000+02:00'
description: >-
OrganisationArende is holding information about the company's last
completed case, such as case number and timestamp when the case was
completed.
Sakfragor:
title: Sakfragor
type: object
properties:
sakfraga:
$ref: '#/components/schemas/KodKlartext'
avslutsorsak:
$ref: '#/components/schemas/KodKlartext'
description: >-
Sakfraga is holding information about what the case is about. Example,
change of business name. Avslutsorsak is the reason why the case is
closed
AktiekapitalforandringRequest:
required:
- identitetsbeteckning
type: object
properties:
identitetsbeteckning:
type: string
description: Company registration number.
example: '5560123456'
fromdatum:
type: string
description: >-
Limit the request for changes in share capital that have occurred
from, and after, this date.
example: '2024-01-01'
tomdatum:
type: string
description: >-
Limit the request for changes in share capital that have occurred
to, and before, this date.
example: '2024-12-31'
description: >
The `identitetsbeteckning` (company registration number). Share capital
changes is only available for limited liability companies.
It is also possible to specify a time interval (`fromdatum` and/or
`tomdatum`).
AktiekapitalforandringResponse:
$ref: '#/components/schemas/AktiekapitalforandringType'
AktiekapitalforandringType:
type: object
properties:
identitet:
$ref: '#/components/schemas/Identitet'
organisationsnamn:
$ref: '#/components/schemas/Organisationsnamn'
organisationsform:
$ref: '#/components/schemas/KodKlartext'
organisationsstatusar:
type: array
description: >-
Code, text and type for the Company status and the registration date
for the status. If typ is 'AvregistreradOrganisationstyp' the
company is no longer active. If typ is
'AvvecklingsOmstruktureringsforfarande' the company is in a process
of status change.
items:
$ref: '#/components/schemas/KodKlartextDatum'
gallandeAktieinformation:
$ref: '#/components/schemas/Aktieinformation'
aktiekapitalforandringar:
type: array
description: List of historical changes in share capital for the company.
items:
$ref: '#/components/schemas/Aktiekapitalforandringsinformation'
bemyndiganden:
type: array
description: List of historical changes in authorisations for the company.
items:
$ref: '#/components/schemas/Bemyndigandeinformation'
skuldebrev:
type: array
description: List of historical changes in debt instruments for the company.
items:
$ref: '#/components/schemas/Skuldebrevsinformation'
description: The changes of share capital in a company returned in the response.
Aktiekapitalforandringsinformation:
title: Aktiekapitalforandringsinformation
type: object
properties:
arende:
$ref: '#/components/schemas/OrganisationArende'
aktieinformation:
$ref: '#/components/schemas/Aktieinformation'
aktiekapitalforandring:
type: array
items:
$ref: '#/components/schemas/Aktiekapitalforandring'
description: >-
Aktiekapitalforandringsinformation is holding information about a
historical change in share capital. Aktieinformation contains
information about share capital for the company after the change.
Bemyndigandeinformation:
title: Bemyndigandeinformation
type: object
properties:
arende:
$ref: '#/components/schemas/OrganisationArende'
bemyndigandegrupper:
type: array
items:
$ref: '#/components/schemas/Bemyndigandegrupp'
description: >-
Bemyndigandeinformation is holding information about a historical change
in authorisations.
Skuldebrevsinformation:
title: Skuldebrevsinformation
type: object
properties:
arende:
$ref: '#/components/schemas/OrganisationArende'
skuldebrev:
$ref: '#/components/schemas/SkuldebrevType'
description: >-
Skuldebrevsinformation is holding information about a historical change
in debt instruments.
Aktiekapitalforandring:
title: Aktiekapitalforandring
type: object
properties:
lopnummer:
type: string
typ:
$ref: '#/components/schemas/KodKlartext'
valuta:
$ref: '#/components/schemas/KodKlartext'
aktiekapital:
type: object
properties:
belopp:
type: number
description: Amount.
lagst:
multipleOf: 0.000001
type: number
description: 'Minimum capital of something, for example shares.'
example: 25000
hogst:
multipleOf: 0.000001
type: number
description: 'Maximum capital of something, for example shares.'
example: 100000
betaltInklusiveOverkurs:
multipleOf: 0.000001
type: number
description: Payment made including share premium.
example: 100000
description: Share capital.
antalAktier:
type: integer
description: Number of shares.
format: int64
beslutAvInstans:
$ref: '#/components/schemas/BeslutAvInstans'
nyemission:
type: object
properties:
betalningssatt:
type: array
description: Method of payment.
items:
$ref: '#/components/schemas/KodKlartext'
belopp:
type: number
description: Amount.
betaltAntalAktier:
type: integer
description: Number of shares paid.
format: int64
fullbetalning:
type: boolean
description: Paid in full.
delregistrering:
type: boolean
description: Partial registration
description: New issue of shares.
minskning:
type: object
properties:
minskningAvAktiekapitalPagar:
type: boolean
description: Ongoing reduction of share capital.
forfallen:
type: object
properties:
beslutAvInstans:
$ref: '#/components/schemas/BeslutType'
description: Overdue.
tillstand:
type: object
properties:
beviljatAvInstans:
$ref: '#/components/schemas/BeslutType'
description: Permit.
belopp:
type: number
description: Amount.
description: Reduction of share capital.
genom:
type: array
description: Share capital change type.
items:
$ref: '#/components/schemas/KodKlartext'
andamal:
type: array
description: Purpose.
items:
$ref: '#/components/schemas/KodKlartext'
aktieslag:
type: array
description: Class of shares.
items:
$ref: '#/components/schemas/AktieslagUtanAktieslagGranser'
fritext:
type: string
description: Free text.
skuldebrevUtgivetIArendenummer:
type: string
description: Debt instrument published in case number.
aktiekapitalEfterAndring:
type: number
description: Calculated amount for each lopnummer
description: Change of share capital.
Bemyndigandegrupp:
type: object
properties:
lopnummer:
type: string
fritext:
type: string
bemyndiganden:
type: array
description: Authorisations.
items:
$ref: '#/components/schemas/Bemyndigande'
description: Group of authorisations.
Bemyndigande:
type: object
properties:
typ:
$ref: '#/components/schemas/KodKlartext'
bemyndigandeDatum:
type: string
description: Date of authorisation.
format: date
bemyndigandeAnvandsFore:
type: object
properties:
ordinarieBolagsstammaAr:
type: integer
description: Year for annual general meeting.
annatDatum:
type: string
description: Other date.
format: date
description: Authorisation must be used before.
description: Authorisation.
SkuldebrevType:
type: object
properties:
lopnummer:
type: string
typ:
$ref: '#/components/schemas/KodKlartext'
beslutAvInstans:
$ref: '#/components/schemas/BeslutAvInstans'
valuta:
$ref: '#/components/schemas/KodKlartext'
forandringsbelopp:
type: object
properties:
beslutatBelopp:
type: number
description: Amount.
lagst:
multipleOf: 0.000001
type: number
description: 'Minimum capital of something, for example shares.'
example: 25000
hogst:
multipleOf: 0.000001
type: number
description: 'Maximum capital of something, for example shares.'
example: 100000
description: Amount of change.
tecknatBelopp:
type: number
description: Subscribed amount for shares.
aktieslag:
type: string
description: Class of shares.
aktiekapitalKanOkasMedBelopp:
type: number
description: Share capital can be increased by amount.
teckningsoptioner:
type: object
properties:
belopp:
type: number
description: Amount.
aktieteckning:
$ref: '#/components/schemas/Teckningstid'
antal:
type: object
properties:
faktisktAntal:
type: integer
description: Actual number.
lagst:
type: number
description: Minimum number.
hogst:
type: number
description: Maximum number.
description: Number of subscription options.
utanLan:
type: boolean
description: Subscription option made without a loan.
medLan:
type: boolean
description: Subscription option made with a loan.
tidForNyteckning:
$ref: '#/components/schemas/Teckningstid'
description: Subscription option.
konvertibler:
type: object
properties:
belopp:
type: number
description: Amount.
utbyte:
type: object
properties:
from:
type: string
description: From this date.
format: date
tom:
type: string
description: To this date.
format: date
description: Exchange.
description: Convertible debt instruments.
fritext:
type: string
description: Free text.
description: Debt instrument.
BeslutAvInstans:
type: object
properties:
instanstyp:
$ref: '#/components/schemas/KodKlartext'
beslutsdatum:
type: string
description: Date for decision.
format: date
description: Decision by authority.
Teckningstid:
type: object
properties:
from:
type: string
description: From this date.
format: date
tom:
type: string
description: To this date.
format: date
description: Time for subscription for shares.
OrganisationsengagemangRequest:
title: OrganisationsengagemangRequest
required:
- identitetsbeteckning
type: object
properties:
identitetsbeteckning:
type: string
description: The `identitetsbeteckning` (personal identity number).
paginering:
type: object
properties:
sida:
type: integer
description: >-
The page of the total hits you want to recieve in the response.
For example, page 0 returns the first page of the total hits.
format: int32
example: 0
antalPerSida:
type: integer
description: How many hits you want per returned page.
format: int32
example: 10
description: >-
Values for pagination of the response. Default values are 0 for sida
and 1000 for antalPerSida.
sortering:
required:
- attribut
- sorteringsordning
type: object
properties:
attribut:
type: string
description: >-
The attribute to sort by. Organisationsform is legal form for
the organisation and registreringstidpunkt is time of
registration for company's last case in our register.
enum:
- ORGANISATIONSFORM
- REGISTRERINGSTIDPUNKT
sorteringsordning:
type: string
description: >-
The order in which you want to sort the response. ASC -
ascending order, from smallest to largest. DESC - descending
order, from largest to smallest.
enum:
- ASC
- DESC
description: >-
Values for sorting of the response. If no values are given sorting
is done descending by time of registration for company's last case
in our register.
filtrering:
type: object
properties:
must:
type: array
items:
$ref: '#/components/schemas/Filter'
mustNot:
type: array
items:
$ref: '#/components/schemas/Filter'
should:
type: array
items:
$ref: '#/components/schemas/Filter'
description: List of objects that allows the reply to be filtered.
description: >-
Object data about an individual’s or a company’s assignments in other
companies.
Filter:
title: Filter
required:
- attribut
type: object
properties:
attribut:
type: string
description: The attribute used as the basis for filtering.
description: An object that allows the reply to be filtered.
discriminator:
propertyName: attribut
mapping:
FUNKTIONARSROLL: '#/components/schemas/FunktionarsrollsFilter'
ORGANISATIONSFORM: '#/components/schemas/OrganisationsformsFilter'
ORGANISATIONSMARKERING: '#/components/schemas/OrganisationsmarkeringsFilter'
ORGANISATIONSSTATUS: '#/components/schemas/OrganisationsstatusFilter'
FunktionarsrollsFilter:
title: FunktionarsrollsFilter
allOf:
- $ref: '#/components/schemas/Filter'
- required:
- varde
type: object
properties:
varde:
type: string
enum:
- AK
- ARB
- BO
- DELG
- EFT
- EVD
- EVVD
- FO
- FTR
- FV
- HREV
- HREVH
- HREVS
- IN
- KD
- KP
- LE
- LI
- LS
- OF
- PO
- REP
- REV
- REVH
- REVL
- REVS
- REVSL
- REVST
- REVT
- SU
- SVD
- VD
- VLE
- VOF
- VVD
OrganisationsformsFilter:
title: OrganisationsformsFilter
allOf:
- $ref: '#/components/schemas/Filter'
- required:
- varde
type: object
properties:
varde:
type: string
enum:
- AB
- BAB
- BF
- BFL
- BRF
- E
- EB
- EEIG
- EGTS
- EK
- FAB
- FF
- FL
- FOF
- HB
- I
- KB
- KHF
- MB
- OFB
- OTPB
- S
- SB
- SCE
- SE
- SF
- TPAB
- TPF
- TSF
OrganisationsmarkeringsFilter:
title: OrganisationsmarkeringsFilter
allOf:
- $ref: '#/components/schemas/Filter'
- required:
- varde
type: object
properties:
varde:
type: string
enum:
- LAGER
OrganisationsstatusFilter:
title: OrganisationsstatusFilter
allOf:
- $ref: '#/components/schemas/Filter'
- required:
- varde
type: object
properties:
varde:
type: string
enum:
- AVREGISTRERAD_ORGANISATION
- AVVECKLINGS_OMSTRUKTURERINGSFORFARANDE
OrganisationsengagemangResponse:
$ref: '#/components/schemas/Organisationsengagemangsinformation'
Organisationsengagemangsinformation:
title: Organisationsengagemangsinformation
type: object
properties:
totaltAntalTraffar:
type: integer
description: Number of total hits for the request.
format: int32
example: 79
sida:
type: integer
description: Returned page of total hits for the response.
format: int32
example: 0
antalPerSida:
type: integer
description: Number of hits per page in the response
format: int32
example: 10
funktionarsOrganisationsengagemang:
$ref: '#/components/schemas/FunktionarsOrganisationsengagemang'
FunktionarsOrganisationsengagemang:
title: FunktionarsOrganisationsengagemang
type: array
description: Companies in which the person or company is a company officer.
items:
title: Organisationsengagemang
type: object
properties:
organisation:
title: organisation
type: object
properties:
identitet:
$ref: '#/components/schemas/Identitet'
namnskyddslopnummer:
type: integer
description: >
"Namnskyddslopnummer" is used to separate companies for
organisation types that can have more than one company on the
same "identitetsbeteckning" (company registration number). For
example Enskild näringsverksamhet can have more than one
company with different names on the same company registration
number.
example: 2
organisationsnamn:
$ref: '#/components/schemas/Organisationsnamn'
organisationsform:
$ref: '#/components/schemas/KodKlartext'
organisationsstatusar:
type: array
items:
$ref: '#/components/schemas/KodKlartextDatum'
description: Company in which the person or the company is a company officer.
funktionar:
$ref: >-
#/components/schemas/OrganisationsengagemangsFunktionarsinformation
OrganisationsengagemangsFunktionarsinformation:
title: OrganisationsengagemangsFunktionarsinformation
allOf:
- $ref: '#/components/schemas/Funktionar'
- type: object
properties:
funktionarsroller:
type: array
description: The roles the company officer has in the company. Code and text.
items:
$ref: '#/components/schemas/KodKlartext'
arFirmatecknare:
type: string
enum:
- JA
- NEJ
anteckning:
type: string
description: Notations done for the company officer.
ApiError:
title: ApiError
required:
- instance
- status
- title
- type
type: object
properties:
type:
type: string
description: |
One of below:
* `about:blank`
* `urn:bolagsverket:error:auth`
* `urn:bolagsverket:error:network`
* `urn:bolagsverket:error:validation`
example: 'urn:bolagsverket:error:validation'
instance:
type: string
description: >
A certain value on `instance` is a unique type of error but also
associated with a `type`, that is one value on `instance` shall only
occur with a value on `type`.
**General**: `about:blank`
- `not.found` information not found
- `server.error` internal server error
**Access control**: `urn:bolagsverket:error:auth`
- `auth.error` authentication error
**Validation**: `urn:bolagsverket:error:validation`
- `validation.client` validation error of client request
**Network**: `urn:bolagsverket:error:network`
- `network.timeout` network timeout
- `network.error` internal network error
example: validation.client
status:
type: integer
description: HTTP status.
example: 400
timestamp:
type: string
description: Date and time in ISO 8601 format.
format: date-time
example: '2021-02-03T13:45:16.953149+02:00'
requestId:
type: string
description: 'Identity associated with the API call, sent in header X-Request-Id.'
example: d120654c-0d09-481a-8956-940a76474e6b
title:
type: string
description: Short description of the error.
example: Fel format
detail:
type: string
description: Detailed description of the error.
example: 'Identitetsbeteckning måste vara 10 eller 12 siffror: A7696151111'
code:
type: string
description: >-
The error as a pre-defined code. A possible use case of this field,
is for different logic in the client.
example: FM003
source:
type: string
description: Name of the parameter causing the error.
example: identitetsbeteckning.identitet.id
description: >-
Error information. Based on [RFC
7807](https://tools.ietf.org/html/rfc7807).
responses:
WrongIdentifier:
description: Wrong format on identifier.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ApiError'
WrongToken:
description: Wrong access token.
headers:
X-Request-Id:
description: Identification of the API-call
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
Forbidden:
description: 'Forbidden call, check the scope.'
headers:
X-Request-Id:
description: ID on the call
style: simple
explode: false
schema:
type: string
example: d120654c-0d09-481a-8956-940a76474e6b
MissingData:
description: Personal data or company data is missing.
content:
application/json; charset=utf-8:
schema:
$ref: '#/components/schemas/ApiError'
examples:
not-found:
summary: Information on identity number is not available in this API.
value:
type: 'urn:bolagsverket:error:validation'
instance: validation.client
status: 400
timestamp: '2021-02-03T13:45:16.953149+02:00'
requestId: d120654c-0d09-481a-8956-940a76474e6b
title: Fel format
detail: 'Identitetsbeteckning måste vara 10 eller 12 siffror: A7696151111'
code: FM003
source: identitetsbeteckning.identitet.id
securitySchemes:
OAuth2:
type: oauth2
flows:
clientCredentials:
tokenUrl: /oauth2/token
scopes:
'foretagsinformation:read': Read rights to Företagsinformation
'foretagsinformation:monitor': Monitor rights to Företagsinformation
'foretagsinformation:test': Läsbehörighet för test vid restricted
x-scopes-bindings:
'foretagsinformation:read': api-foretagsinformation-read
'foretagsinformation:monitor': api-foretagsinformation
'foretagsinformation:test': api-foretagsinformation-test
BearerToken:
type: http
scheme: bearer
default:
type: oauth2
flows:
implicit:
authorizationUrl: 'https://gw.api.bolagsverket.se/authorize'
scopes:
'foretagsinformation:monitor': Monitor rights to Företagsinformation
'foretagsinformation:read': Read rights to Företagsinformation
'foretagsinformation:test': Läsbehörighet för test vid restricted
x-scopes-bindings:
'foretagsinformation:monitor': api-foretagsinformation
'foretagsinformation:read': api-foretagsinformation-read
'foretagsinformation:test': api-foretagsinformation-test